home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 4 / Meeting Pearls Vol. IV (1996)(GTI - Schatztruhe)[!].iso / Pearls / libs / ReqTools / README < prev    next >
Text File  |  1996-06-12  |  60KB  |  1,120 lines
  1.  
  2.                       **********************************
  3.  
  4.                           reqtools.library
  5.  
  6.                           The requester toolkit.
  7.  
  8.                           Release 2.6
  9.  
  10.                           (c) 1991-1994 Nico François
  11.                               1995-1996 Magnus Holmgren
  12.  
  13.                       **********************************
  14.  
  15.  
  16.    First of all read the DISTRIBUTION file for information on... er well...
  17. distribution :-)
  18.  
  19.    If you have suggestions or remarks about ReqTools, or if you find any
  20. bugs, please let me know.
  21.  
  22.    Contacting the author:
  23.  
  24.      FidoNet:  2:292/603.10 (Nico Francois)
  25.  
  26.      Internet: nico@augfl.be
  27.  
  28.      Mail:     Nico François
  29.                Corbielaan 13
  30.                B-3060 Bertem
  31.                BELGIUM
  32.  
  33.    If you can please use e-mail.  That way you'll stand a much better
  34. chance of getting a reply quickly.
  35.  
  36.  
  37.    ----------
  38.    IMPORTANT!
  39.    ----------
  40.  
  41.    As of release 2.3, the programming is made by:
  42.  
  43.      Magnus Holmgren
  44.      Kvarnbergsvägen 5
  45.      S-444 47  Stenungsund
  46.      SWEDEN
  47.  
  48.      FidoNet:  2:203/512.10 (Magnus Holmgren)
  49.  
  50.      Internet: cmh@lls.se
  51.  
  52.    Please contact me instead, for suggestions, remarks, bug reports and the
  53. like (btw, I prefer e-mail too). If you are interested in updating RTPatch
  54. (for some reasons, I'm not really that interested in putting any large
  55. amount of work into it ;), feel free to contact me as well.
  56.  
  57.    Nico sent me the sources since he didn't have the time to work on
  58. ReqTools.
  59.  
  60.  
  61. Contents
  62. ========
  63.  
  64. 1. Introduction
  65.  
  66. 2. Features
  67.  
  68. 3. Installation
  69.  
  70. 4. Using reqtools.library
  71.  
  72.  
  73. 1. Introduction
  74. ===============
  75.  
  76.     reqtools.library is a standard Amiga shared, runtime library.  The
  77. purpose of ReqTools is to make it a lot quicker and easier to build
  78. standard requesters into your programs.  ReqTools is designed with
  79. Commodore's style guidelines in mind, all requesters have the look-and-feel
  80. of AmigaDOS Release 2.
  81.  
  82.     If you use ReqTools in your programs you do not have to worry about
  83. requesters too much.  You'll have a lot more time to concentrate on the
  84. really important stuff your program does.
  85.  
  86.     The library has been inspired by req.library (by Colin Fox & Bruce
  87. Dawson) and Commodore's own asl.library.  You will find it shares a lot of
  88. the features with these two libraries, while it has some additional ones as
  89. well. While asl.library was great in look-and-feel I felt it lacked quite a
  90. bit in the power department.  This power _is_ mostly available in
  91. req.library, but this doesn't fit in too well with AmigaDOS Release 2.  So
  92. the idea for a new requester library was born.
  93.  
  94.     I tried to make all requesters in ReqTools very powerful, easy to use
  95. and with a very nice new-look 3D interface.  Efficiency was also considered
  96. very important.  The 2.0 version of the library is about 45K large.  I'm
  97. sure you will agree this is not too much considering what ReqTools offers.
  98.  
  99.     ReqTools features the following requesters:  a query requester, a
  100. string requester, a number requester, a file requester, a font requester, a
  101. palette requester and new in release 2.0 of ReqTools a volume requester and
  102. a screen mode requester.
  103.  
  104.  
  105. 2. Features
  106. ===========
  107.  
  108.    The requesters have following features:
  109.  
  110.    All requesters:
  111.  
  112.       o have a pixel-perfect Workbench 2.0 3D look, also on Kickstart 1.3.
  113.       o Completely localized!  If you are using Workbench 2.1 or higher the
  114.         text in ReqTools requesters will appear in the language of your
  115.         Workbench (if the catalog for this language is available).
  116.       o adjust to interlaced screens and to the screen's font (rtEZRequest,
  117.         rtGetLong, rtGetString) or to any fixed-width font if the screen's
  118.         font is proportional (rtPaletteRequest/rtFileRequest/rtFontRequest).
  119.         Requesters can also use any suitable font you specify.
  120.       o can appear under the mouse pointer, centered on the
  121.         screen/in a window or at the top left of the screen/a window.
  122.       o can be used asynchronously.
  123.       o check pr_WindowPtr of your process is to find the screen they should
  124.         appear on (can be overridden).
  125.       o use tags for maximum future extendibility.  All standard 2.0 tags
  126.         are supported (like TAG_SKIP, TAG_MORE, etc.).
  127.       o bring the screen they appear on to the front.  The screen that was
  128.         in front previously will be put in front again when the requester
  129.         finishes (if it is still open).
  130.         This behaviour can be switched off.
  131.       o will always appear in the visible portion of the screen (support of
  132.         virtual screens).
  133.       o are extensively tested using enforcer and mungwall debugging tools.
  134.       o have the ability to lock the parent window from all user input and
  135.         give it a standard wait pointer automatically.
  136.       o can share the IDCMP port of the parent window.
  137.       o supports a callback hook for handling IDCMP messages from a shared
  138.         IDCMP port.
  139.       o have keyboard shortcuts for gadgets (key underlined in gadget
  140.         label). Use Right Amiga key with shortcut if a string gadget is
  141.         active.
  142.       o have a zoom gadget.
  143.  
  144.    rtEZRequest, the query requester:
  145.  
  146.       o easy keyboard shortcuts:
  147.         - Left Amiga V and Left Amiga B (like the standard requesters).
  148.         - Y for positive response.
  149.         - N, R, Esc for negative response.
  150.         - Return can also be used as a shortcut and can be
  151.           associated with any response.  The gadget in question
  152.           will have its text printed bold.
  153.           Default response for Return is the positive response.
  154.         - buttons give visual feedback when keyboard shortcuts
  155.           are used.
  156.         - keyboard shortcuts can be canceled by pressing Shift
  157.           before releasing the key.
  158.         - keyboard shortcuts can be defined to be any character in the
  159.           button's label.  The character in question will be underlined.
  160. *NEW*   - function keys can be used to select the "first" ten gadgets.
  161.       o number of responses only limited by screen width.
  162.       o allows for multiple lines of text.
  163.       o text can be centered in requester (great for about requesters).
  164.       o supports the use of 'printf' formatting codes in text
  165.         and in responses.
  166.       o can be terminated by IDCMP events.
  167.  
  168.    rtFileRequest, the file requester:
  169.  
  170.       o similar in use and look-and-feel as Asl file requester.
  171.       o buffers directories in memory.
  172.       o files and directories can be added or removed from the buffer
  173.         by the calling program.
  174.       o can be put in save mode, disabling double-clicks and asking you if
  175.         directories that can't be found (entered manually) should be
  176.         created.
  177.       o optional callback hook for verification of files before they are
  178.         added to the buffer.
  179.       o supports multiple selection of files and optionally of directories.
  180.       o when multi-select is on All, Clear and Match.. buttons are
  181.         available. All selects, and Clear unselects all files.  Match..
  182.         brings up a requester where the user can enter a pattern to select
  183.         files.
  184.       o can be used as a directory requester (showing no files).
  185.       o optional pattern gadget to match files on.
  186.       o shows all devices (with volume names) and all assigns made.
  187.       o supports TABCYCLE under 2.0
  188.       o pattern matching supports _ALL_ AmigaDOS 2.0 patterns.
  189.       o can be used as a volume requester to get a device or an assign
  190.         from the user.
  191.       o can be resized in height to show more files.
  192.       o Shows disk percentage used next to volume names.
  193.       o Allows you to enter paths in the filename string gadget.  If the
  194.         requester finds a path in the filename it will change the directory
  195.         to that path.  So if you e.g. enter 'Devs:mountlist' in the filename
  196.         gadget the requester will read the 'Devs:' directory and set the
  197.         filename gadget to 'mountlist'.  If you enter 'printers/' it will go
  198.         into the printers directory. Enter '/' to go to the parent
  199.         directory.
  200.       o Completely keyboard controlable: use up and down cursor keys to
  201.         select files or directories.  Use Shift-Up and Shift-Down to jump
  202.         by one window-full.  Use Ctrl-Up and Ctrl-Down to jump to the start
  203.         or end of the directory.
  204.  
  205.    rtFontRequest, the font requester:
  206.  
  207.       o buffers all fonts in memory.
  208.       o shows sample of font you click on.
  209.       o can be also be used to select the font's style.
  210.       o supports color fonts, can change the screen's palette.
  211.       o supports scaled fonts (AmigaOS Release 2 only).
  212.       o optional callback hook for verification of fonts before they are
  213.         added to the buffer.
  214.       o supports TABCYCLE under 2.0
  215.       o can be resized in height to show more fonts.
  216.       o makes sure selected font is visible in listview when it comes up.
  217.  
  218.    rtScreenModeRequest, the display mode requester (Kickstart 2.0+ only!):
  219.  
  220.       o all modes in the DisplayInfo database can be displayed.
  221.       o allows you to pick a standard overscan setting.
  222.       o user may enter prefered size or choose to get the defaults.
  223.       o number of colors selectable.
  224.       o can be put up with the attributes from a given screen.
  225.       o optional callback hook for examining a display mode before it is
  226.         added to the requester.
  227.       o can be resized in height to show more modes.
  228.       o makes sure selected mode is visible in listview when it comes up.
  229.  
  230.    rtPaletteRequest, the palette requester:
  231.  
  232.       o features Copy, Swap and Spread functions.
  233.       o current values of red, green and blue are displayed.
  234.       o returns the selected color.
  235. *NEW* o optionally displays a colorwheel.
  236.  
  237.    rtGetLong, the long integer requester:
  238.  
  239.       o width of requester can be set by caller.
  240.       o a minimum and maximum can be supplied and will be displayed
  241.         in the requester.
  242.       o a value to show up when the requester appears can be supplied.
  243.       o can display buttons with several possible responses.
  244.       o invisible entry is possible (useful for getting a code number).
  245.       o patterned backfill of requester can be switched on or off.
  246.       o some line(s) of (centered) text may be displayed above the entry
  247.         gadget to give the user some extra information.
  248.  
  249.    rtGetString, the string requester:
  250.  
  251.       o width of requester can be set by caller.
  252.       o a string to show up when the requester appears can be supplied.
  253.       o can display buttons with several possible responses.
  254.       o invisible entry is possible (useful for getting a password).
  255.       o patterned backfill of requester can be switched on or off.
  256.       o some line(s) of (centered) text may be displayed above the entry
  257.         gadget to give the user some extra information.
  258.  
  259.  
  260. 3. Installation
  261. ===============
  262.  
  263.    To install reqtools.library copy it to your Libs: directory by hand, or
  264. run the installation script 'Install' (by using 'Execute' from the Shell or
  265. by double-clicking its icon).
  266.  
  267.    If you are running Workbench 2.1 or higher you will have the possiblity
  268. to use ReqTools in different languages.  Just use the appropriate install
  269. script in the Install/Workbench_2.1+ directory.
  270.  
  271.  
  272. 4. Using reqtools.library
  273. =========================
  274.  
  275.    If you are a C programmer all you need to do is include the correct
  276. header ('libraries/reqtool.h') and open reqtools.library. After that you
  277. can use the functions in the library as if they were C functions. If your
  278. program quits it must of course close the library again. See 'demo.c' for
  279. an example.
  280.  
  281.    Glue code for several compilers/languages is included with ReqTools 2.4.
  282. Look in the Glue directory of the ReqTools distribution to see if glue code
  283. exists for your compiler and/or programming language.  If it doesn't and
  284. you write your own please send it to me and I'll include it in the next
  285. release of ReqTools.
  286.    Note that the source for the Manx C libraries is the same as for the
  287. SAS/C libraries.  See the README.Manx file in the archive
  288. 'Glue/Sas-C/LibSource.lha'.
  289.    Manx C users may have to edit 'libraries/reqtools.h' and change the
  290. library (GfxBase, IntuitionBase, etc.) fields to rt_GfxBase,
  291. rt_IntuitionBase etc. Seems there is a bug in some versions of the Manx C
  292. compiler that has problems otherwise.  Let's hope this gets fixed soon :-)
  293.  
  294.    Functions allowing a variable number of arguments can't be called using
  295. pragmas (in-line library calls, no glue code required).  So if you use
  296. these you must always link with LIB:reqtools.lib or LIB:reqtoolsnb.lib (for
  297. SAS-C, or with the specific libraries for your compiler/language).
  298.  
  299.    Assembly programmers should also include the correct files and open
  300. reqtools.library.  To call a function they must load A6 with the library
  301. base, put the arguments in the appropriate registers and jump to the
  302. library vector offset of the function they want to call.
  303.  
  304.    Remember to open the library with a specific version number if you wish
  305. to use features only found in that version (for example: screen mode
  306. requester).
  307.  
  308.    All library functions are explained in the autodoc file 'reqtools.doc'.
  309.  
  310.                                                        Enjoy.
  311.  
  312.  
  313. 5. The Future
  314. =============
  315.  
  316.    This release is only a minor update, so I've tried to keep things as
  317. they were. I don't intend to make any major work to the current sources
  318. (maybe some minor updates and bug fixes), as my intention is to make a
  319. (more or less) complete rewrite of ReqTools. I have the famous TODO file
  320. Nico maintained, and I'll try to add any useful suggestions found therein.
  321. There are also some other nice features planned, like e.g. an API (so that
  322. the application - or external "modules" - can extent ReqTools). Exact
  323. details have not yet been worked out.
  324.  
  325.    If you have a suggestion you don't think is in the TODO file, feel free
  326. to tell me about it.
  327.  
  328.  
  329.                                LIBRARY HISTORY:
  330.  
  331. *****************************************************************************
  332. RELEASE 1.0 (Library version 37.556 [1.3] - 37.670 [2.0])
  333.  
  334.     First release.
  335.  
  336. *****************************************************************************
  337. RELEASE 1.0a (Library version 37.557 [1.3] - 37.673 [2.0])
  338.  
  339.     Fixed two minor bugs:
  340.       - if a directory could not be found and you re-invoked the file
  341.         requester it wouldn't check the directory again.
  342.       - devices like PRT:, CON:, etc. now no longer show up in the device
  343.         list of the 2.0 file requester.
  344.  
  345. *****************************************************************************
  346. RELEASE 1.0b (Library version 37.566 [1.3] - 37.678 [2.0])
  347.  
  348.     Fixed bug: entering a pattern when a file requester's directory was
  349.       invalid could cause a crash.
  350.     rtGetString() and rtGetLong() 2.0 requester windows no longer have close
  351.       gadgets.
  352.     Font requester entries are "release verify" instead of "immediate".
  353.     If no minimum or maximum is given for the GetLong requester it will not
  354.       be displayed (1.0 and 1.0a displayed MAXINT or MININT).
  355.     Minor cosmetic adjustments to file, font and palette requesters.
  356.     Oberon interface to the library included.
  357.  
  358. *****************************************************************************
  359. RELEASE 1.0c (Library version 37.592 [1.3] - 37.718 [2.0])
  360.  
  361.     Boopsi dispatch function for rtEZRequestA() buttons optimized (ReqTools
  362.       for Kickstart 2.0).  Occasional flicker just about eliminated.
  363.     Enlarged buttons a bit in rtGetLongA(), rtGetStringA() and the file, font
  364.       and palette requesters.
  365.     Width of scroller gadget in file requester window increased.
  366.     File string gadget is cleared when 'All' or 'Match..' is used.  This
  367.       wasn't done before and could result in unexpected multi-select results.
  368.     Visual feedback for keyboard shortcuts improved (rtEZRequestA()).  Button
  369.       stays depressed as long as the key in question is held down, but still
  370.       for a minumum of 1/10 sec.  New feature:  shortcuts can be canceled by
  371.       pressing Shift before releasing the key.
  372.     Minor bug fix: keyboard shortcuts V and B now really only work together
  373.       with the Left Amiga key.  Used to work without the qualifier.
  374.     rtEZRequestA(), rtGetLongA() and rtGetStringA() will no longer call the
  375.       DOS function Delay(), so they may from now on be called by tasks.
  376.       Every ReqTools requester, except the file and font requesters (they use
  377.       DOS for obvious reasons), can be called from a task.
  378.     EZRequest with only one button now responds to the Return key, whether
  379.       EZREQF_NORETURNKEY is set or not.
  380.     Fixed small bug in libraries/reqtools.i include file.  rtfi_Hook and
  381.       rtfo_Hook were followed by a ; and this could lead to problems.
  382.     Libraries (reqtoolss.lib and reqtoolssr.lib) for Dice C included.
  383.     Pre-release (0.91ß) of RTPatch patcher program included.
  384.  
  385. *****************************************************************************
  386. RELEASE 1.0d (Library version 37.600 [1.3] - 37.726 [2.0])
  387.  
  388.     rtEZRequestA(), rtGetStringA() and rtGetLongA() now switch the processor
  389.       stack to ensure sufficient stack space for the function to succeed.
  390.     Fixed bug in rtGetLong() requester in 2.0 version of ReqTools.  Used to
  391.       return TRUE and a random value if the user pressed Ok when the integer
  392.       gadget was empty.
  393.     File requester is somewhat larger by default.
  394.     Improved automatic requester resizing (if requester would become too big
  395.       for the screen).
  396.     File requester (in save mode) no longer asks "Create drawer?" when you
  397.       entered a drawer string containing a non-existing volume (e.g. 'FOO:').
  398.     Entries in file requester are now sorted immediately when you select the
  399.       slider gadget and not when you release it (1.3 version of ReqTools).
  400.     Latest revision of Oberon interface included.
  401.     Modula-2 interface to the library included.
  402.     Manx C interface to the library included.
  403.  
  404. *****************************************************************************
  405. RELEASE 1.0e (Library version 37.600 [1.3] - 37.726 [2.0])
  406.  
  407.     Rearranged directories a bit.  All glue code now in one directory.
  408.     Installation script now uses Commodore's Installer utility.
  409.     Two Modula-2 interfaces to the library are now included, one for M2Sprint
  410.       and one for M2Amiga.
  411.     Some bugs in the Dice C libs have been fixed (thanks to Magnus Holmgren).
  412.     Interface for HiSoft's HighSpeed Pascal included.
  413.  
  414. *****************************************************************************
  415. RELEASE 2.0 (Library version 38.347 [1.3] - 38.693 [2.0])
  416.  
  417.     All requesters now have keyboard shortcuts.
  418.     Kickstart 2.0 version of ReqTools has been localized.  As long as the
  419.       appropriate catalog file exists ReqTools will appear in the user's
  420.       selected langauge.
  421.     New requester: rtScreenModeRequestA().  A screen mode requester. Can be
  422.       used to get a screen mode, size, depth and overscan type from the user.
  423.       This requester is only available on Kickstart 2.0 or higher, but also
  424.       present in the Kickstart 1.3 version of ReqTools.
  425.     File, font and screenmode requesters are now resizable (in height).
  426.     Font, volume and screen mode requesters will now make sure the current
  427.       entry is visible in the listview when the requester first comes up.
  428.     Improved DOWILDFUNC hook interface.  New tag: RTxx_FilterFunc. Old hook
  429.       interface (using req->Hook and FREQF_DOWILDFUNC flag) is still
  430.       supported, but declared obsolete.  Don't use in new code.
  431.     Several new tags:
  432.       o RT_Locale:  specify a locale to be used instead of the default one.
  433.         Ignored if locale.library isn't present in the system or you are
  434.         using the Kickstart 1.3 version of ReqTools.
  435.       o RT_ShareIDCMP and RT_IntuiMsgFunc:  All requesters can now share
  436.         their IDCMP port with the parent window.  A callback hook for
  437.         intuition messages received not concerning the requester can also be
  438.         set using the RT_IntuiMsgFunc tag.
  439.       o RT_LockWindow:  Enables you to make ReqTools lock the parent window
  440.         from all user input and give the window a standard wait pointer.
  441.         After the requester returns the window will be unlocked and will get
  442.         its original pointer back.
  443.       o RT_Underscore:  With this tag it is possible to define keyboard
  444.         shortcuts for buttons.  You can ask ReqTools to underline a character
  445.         in the button's label and use this as a shortcut.
  446.       o for rtGetString() and rtGetLong(): RTGS_GadFmt, RTGS_GadFmtArgs,
  447.         RTGL_GadFmt and RTGL_GadFmtArgs.  With these tags you may give the
  448.         user several ways out of the string/long requester.
  449.       o for rtGetString() and rtGetLong(): RTGS_Invisible and RTGL_Invisible.
  450.         Can be used to switch on invisible typing to get a password or a code
  451.         number from the user.
  452.       o RTGS_TextFmt, RTGL_TextFmt, RTGS_TextFmtArgs and RTGL_TextFmtArgs:
  453.         These tags allow you to supply some line(s) of text that should be
  454.         printed above the string/integer gadget in the rtGetString() or
  455.         rtGetLong() requesters.
  456.       o RTGS_Flags and RTGL_Flags:  Set certain flags for rtGetString() and
  457.         rtGetLong() requesters.  Used to set the GSREQF_CENTERTEXT or
  458.         GLREQF_CENTERTEXT flags.
  459.       o RTGS_BackFill and RTGL_BackFill:  Switch the patterned backfill in
  460.         the rtGetString() and rtGetLong() requesters on or off.
  461.       o RT_ScreenToFront:  Allows you to switch of the default behaviour of
  462.         popping the screen the requester appears on to the front.
  463.       o RT_TextAttr:  Allows you to specify a font a requester should use
  464.         instead of the screen or default font.
  465.       o RTFI_VolumeRequest:  New flavor of file requester: volume requester.
  466.         Allows you to easily get a device/assign from the user.
  467.       o RTFI_AllowEmpty:  Enables you to allow the file requester to accept
  468.         an empty filename.  Normally cancels the requester if no filename
  469.         was entered.
  470.     Changes to file requester:
  471.       o Shows disk percentage used next to volume names.
  472.       o 'Hide .info' cycle gadget gadget in file requester replaced by
  473.         '.info' toggle gadget next to filename string gadget.
  474.       o Will no longer automatically change directories to their full
  475.         pathname.  Will only do so when needed (e.g. parent of an assign).
  476.       o Allows you to enter paths in the filename string gadget.  If the
  477.         requester finds a path in the filename it will change the directory
  478.         to that path.
  479.       o Completely keyboard controlable: use up and down cursor keys to
  480.         select files or directories.  Use Shift-Up and Shift-Down to jump
  481.         by one window-full.
  482.       o 1.3 version has a 2.0-look sizing gadget and bottom border.
  483.       o Changed 'Disks' to 'Volumes'.
  484.       o Changed '(dir)' to 'Drawer' (right justified).
  485.       o Assigns now displayed differently (with 'Assign' right justified).
  486.       o Added an indicator for number of selected files (if multiselect on).
  487.       o No longer shows 'Add', 'Match..' and 'Clear' gadgets if no multi-
  488.         select is possible.
  489.     New library functions:
  490.       o rtLockWindow() and rtUnlockWindow():  easily lock a window from user
  491.         input and give it a standard wait pointer.
  492.       o rtCloseWindowSafely():  close a window with a shared IDCMP port.
  493.     Updated glue code:
  494.       o Oberon interface updated for ReqTools V38.
  495.       o SAS/C, Manx C and Dice glue code updated for ReqTools V38.
  496.       o New HighSpeed Pascal (for ReqTools V38) interface written by
  497.         Gunter Indenhoek included.
  498.     Demo updated to demonstrate new features of ReqTools 2.0.
  499.     Version 1.0 of RTPatch patcher program included.  Patches req.library,
  500.       arp.library and asl.library to use ReqTools requesters instead.
  501.  
  502. *****************************************************************************
  503. RELEASE 2.0a (Library version 38.350 [1.3] - 38.693 [2.0])
  504.  
  505.     Aaaargh!  Just one day after releasing ReqTools 2.0 a MAJOR bug turned
  506.       up in the Kickstart 1.3 version:  rtLockWindow() was broken!!  Only
  507.       turned up when running on 1.3, since on 1.3 there seems to be no return
  508.       value from intuition.library/Request() (So C=, your autodocs have a bug
  509.       in them as well :-).  Bug fixed.
  510.     Fixed broken install script for Workbench 1.3.
  511.  
  512. *****************************************************************************
  513. RELEASE 2.0b (Library version 38.358 [1.3] - 38.803 [2.0])
  514.  
  515.     Installer is no longer distributed with ReqTools. It is copyrighted by
  516.       Commodore and can only be distributed under license. If you have
  517.       Installer (preferably version 2.12 or higher) make sure it is in your
  518.       command path so the install scripts will work. If you don't have
  519.       Installer you'll have to install ReqTools manually, sorry.
  520.     When you use the up/down arrows in the file requester and no file is
  521.       highlighted yet, ReqTools will now highlight the file at the top of
  522.       the visible area (instead of the first file in the list).
  523.     Some small changes in demo, now demonstrates min/max with rtGetLong(),
  524.       return value when RTGS_GadFmt is used and multi-selection in the file
  525.       requester.
  526.     Changed RTGL_BackFill and RTGS_BackFill tags to use the same spelling as
  527.       WA_BackFill in intuition.h (with a capital F).  Be sure to install the
  528.       new include files.
  529.     Install scripts for Workbench 2.0 or higher now also try to update
  530.       RTPatch (if the the file is found in C: or SYS:WbStartup).
  531.     Added icons for install scripts for all 10 languages.  Install strings
  532.       are all more or less translated.  Catalog translation files of all
  533.       languages not supported yet are now also included, making it easier to
  534.       translate ReqTools.
  535.     From this release on ReqTools will make sure the Dir field of the file
  536.       requester structure is pointing to the current directory while in the
  537.       file filter callback hook (RTFI_FilterFunc).
  538.     Changes in the Kickstart 2.0 version of ReqTools:
  539.       o All requesters use simple refresh windows.  Window refreshing is a
  540.         bit slower, but a lot of chip memory is saved.  Very important when
  541.         you use the requesters on screens with a lot of colors/bitplanes.
  542.       o All requesters have a backfill hook installed that will fill the
  543.         background of the window with the DrawInfo pen BACKGROUNDPEN.  The
  544.         DetailPen and BlockPen of the requesters will now also be set to
  545.         DrawInfo pens (BACKGROUNDPEN and SHADOWPEN).
  546.     Bug fixes:
  547.       o When the RTGL_GadFmt or RTGS_GadFmt tag was used the requester did
  548.         not return the correct value.
  549.       o Small problem with requester resizing on virtual screens. Maximum
  550.         number of entries was restricted to fit the visual area. The maximum
  551.         height of the requester's window is now also set correctly.
  552.       o Empty (current) directory no longer cancels the directory requester.
  553.       o Font requester in Kickstart 1.3 version of the library didn't
  554.         show a font if the font was previously opened in another height.
  555.       o Field rt_Flags in 'libraries/reqtools.[hi]' changed to rt_RTFlags
  556.         since it conflicted with the rt_Flags field in 'rexx/storage.[hi]'.
  557.         Shouldn't cause any problems since the field was private anyway.
  558.       o Entering a something like 'MAIL:/' to go to the parent directory
  559.         of MAIL: now works.
  560.     Some small errors and omissions fixed in the autodoc.
  561.     French catalog revised by David Lebel.  Thank you David for correcting
  562.       my lousy french :-)
  563.     Italian and Swedish catalog files included (thanks Michele and Patrik).
  564.     Updated/bug-fixed Oberon interface included.
  565.     Version 1.0a of RTPatch included.
  566.  
  567. *****************************************************************************
  568. RELEASE 2.0c (Library version 38.362 [1.3] - 38.810 [2.0])
  569.  
  570.     Fixed Enforcer hit in file, font and screenmode requesters of the
  571.       Kickstart 2.0 version of the library.
  572.     Fixed bug: when the pr_WindowPtr of the calling process was -1 and you
  573.       used a tag that needed a parent window (like RT_LockWindow or RT_ReqPos
  574.       with REQPOS_CENTERWIN) ReqTools could crash.
  575.     Pattern and drawer string gadgets no longer refresh the directory in the
  576.       requester if they aren't changed.  Especially useful if you cycle
  577.       through the string gadgets with TAB (Kickstart 2.0 version).
  578.     Included a README file explaining ReqTools' installation scripts need
  579.       Commodore's Installer utility.
  580.     Include file 'libraries/reqtools.h' fixed.  This used a BPTR without
  581.       including 'libraries/dos.h'. Thanks to Olaf Barthel for reporting this.
  582.     Danish catalog file included (thanks Per).
  583.     Version 1.0b of RTPatch included.
  584.  
  585. *****************************************************************************
  586. RELEASE 2.1 (Library version 38.382 [1.3] - 38.961 [2.0])
  587.  
  588.     New major feature: ReqTools preference editor (Kickstart 2.0+ only)!
  589.       o Switch screen to front popping on/off.
  590.       o Display drawers before files in file requester.
  591.       o Mix drawers and files in file requester.
  592.       o Sort entries in file requester immediately.
  593.       o Set default position of all requesters.
  594.       o Set default size of file, font, screenmode and volume requesters.
  595.       o Set minumum and maximum number of entries visible in file, font,
  596.         screenmode and volume requesters.
  597.     Kickstart 2.0 (or higher) version of ReqTools only:
  598.       o The file requester will keep its top entry up to date with what is
  599.         typed in the filename string gadget.  Pressing the up or down arrow
  600.         will select the file that most closely matches the contents of the
  601.         filename string gadget.
  602.       o Entering of pathnames in the filename string gadget has been
  603.         improved.  The file requester will now check if what you enter is a
  604.         directory.  This allows you to enter directories without a trailing
  605.         '/' (for example 'SYS:c').
  606.       o rtSetWaitPointer() and rtLockWindow() will set the standard Intuition
  607.         wait pointer on Kickstart 3.0 machines.  Note that rtUnlockWindow()
  608.         will _not_ restore the original pointer if it was a new pointerclass
  609.         pointer (Kickstart 3.0)!
  610.       o File requester is an AppWindow now.  This means you can drop disk,
  611.         drawer or file icons on the requester's window to go to a directory
  612.         or select a file.
  613.       o All requesters now set an appropriate bitplane write mask in the
  614.         rastport of their windows.  This makes them render and scroll much
  615.         faster on a screen with lots of bitplanes/colors.
  616.     Available system fonts will now be buffered for _all_ font requesters.
  617.       This speeds up font requesters enormously, a font scan is generally
  618.       needed only once now.  The version of ReqTools for Kickstart 2.0 (or
  619.       higher) has been made intelligent enough to see if the assign has been
  620.       changed between two requests.  ReqTools will free the buffer when
  621.       memory gets low.  Note that to accomplish this ReqTools keeps its
  622.       library open count 0.  A real open count is kept internally.
  623.     File requester will no longer show deferred (late) assigns.
  624.     Several bug fixes:
  625.       o Small bug: was no longer possible to exit volume/assign list by
  626.         pressing Return in the drawer gadget without changing the directory.
  627.       o Fixed weird bug with the selection of listview entries.  If you
  628.         selected a non-existing item and dragged the mouse up, an item above
  629.         all others would be complemented.  Thanks to Mathias Korsbäck for
  630.         reporting this.
  631.       o No longer goes into an endless loop when LOCALE: could not be found
  632.         when a catalog had to be loaded.  Thanks to Holger Kruse for
  633.         reporting this.
  634.       o Resizing a file requester with an inexisting directory and with the
  635.         volume list displayed resulted in a crash.
  636.       o Some other miscellaneous bugfixes.
  637.     Norwegian catalog file included (thanks Mario).
  638.     Improved and bug fixed Dice C libraries included (by Magnus Holmgren).
  639.       Includes libs for small code model, large code model and both of these
  640.       with the arguments passed in registers.
  641.     M2Amiga interface updated for ReqTools V38 by Frank Lömker.
  642.     PCQ Pascal interface to the library included, written by Chris Pressey.
  643.     Version 1.1 of RTPatch included.
  644.  
  645. *****************************************************************************
  646. RELEASE 2.1a (Library version 38.385 [1.3] - 38.1002 [2.0])
  647.  
  648.     Serious bug fixed: file requester would crash if you tried to type a
  649.       filename in a requester with a shared IDCMP port.
  650.     Some other small bug fixes.
  651.     rtGetString() and rtGetLong() will activate the string/integer gadget
  652.       when the requester window becomes active.  This should make life easier
  653.       for people using AutoPoint or other sunmouse-like utilities.
  654.     New keyboard shortcuts for file requester:  pressing Control-Up/Down will
  655.       bring you to the start/end of the directory list.
  656.     Kickstart 2.0 (or higher) version of ReqTools only: Faster directory
  657.       reading from a fast hard disk or ram disk.  The file requester now
  658.       tries to read as many files as possible in .5 seconds. If this time-out
  659.       expires, or all files have been read, the display is updated for the
  660.       first time.  After this initial time-out period the display will be
  661.       updated every .2 seconds.  This reduces the amount of rendering calls
  662.       substantially and therefore results in faster directory loading.
  663.     German catalog for preference editor included.  German strings in install
  664.       script have also been updated (by Steffen Salzmann, thanks Steffen).
  665.     Danish catalog for preference editor included (thanks Per).
  666.  
  667. *****************************************************************************
  668. RELEASE 2.1b (Library version 38.388 [1.3] - 38.1017 [2.0])
  669.  
  670.     Recompiled with SAS/C 6.1: fixes bug of the filerequester not returning
  671.       CALL_HANDLER when the RT_ReqHandler tag was used.  Seems SAS/C 6.0
  672.       converted (APTR)0x80000000 to 0.  Don't you just love compiler bugs :-)
  673.     File requester will clear the current selection when the filename string
  674.       gadget is changed.  This allows you to use the filename completion
  675.       multiple times in a row.  Also, using Amiga-X in the string gadget will
  676.       no longer bring you to the start of the directory.
  677.     RTSC_ModeFromScreen will now correctly set the autoscroll setting.  The
  678.       default autoscroll setting is now also correctly read from the screen
  679.       the requester will appear on.  Changed reqtools.doc to reflect this
  680.       change.
  681.     Volume and directory requesters will no longer exit when Shift Return is
  682.       pressed (special request by per Jacobsen :-).
  683.     Kickstart 2.0 version of ReqTools only:  Requesters with an inactive
  684.       parent window (using the RT_Window tag) will also open in inactive
  685.       state.  Suggested by Jorrit Tyberghein.
  686.     Now respects EZREQF_NORETURNKEY flag also for single button EZRequesters,
  687.       so the Return shortcut is disabled.  Thanks to Bert Wynants for
  688.       pointing this out.  As a result of this most single-button requesters
  689.       will have their buttontext printed in bold, showing you can use the
  690.       return key.
  691.     String gadget edit hook changed to be more according to the rules (using
  692.       sgwork->EditOp instead of checking for Amiga-X and Amiga-Q by itself).
  693.     Some small bugs in include files fixed.  Thanks to Magnus Holmgren and
  694.       Per Jacobsen for reporting these.
  695.     Italian catalog for preference editor included (thanks Michele).
  696.     Spanish catalogs for library and preference editor included.  Translated
  697.       by Juan Carlos Sanchez Garcia.  I had to edit the catalog for the
  698.       preference editor so the prefs window would fit on a 640x200 screen.
  699.       My apologies to spanish ReqTools users if I made mistakes in doing so.
  700.     German catalog file for preference editor fixed.
  701.     Version 1.1a of RTPatch included.
  702.  
  703. *****************************************************************************
  704. RELEASE 2.1c (Library version 38.388 [1.3] - 38.1020 [2.0])
  705.  
  706.     Requesters with an inactive parent window will no longer open inactive.
  707.       This new feature of ReqTools 2.1b was removed since it was more
  708.       annoying than helpful.  Jorrit will be shot at dawn... ;-)
  709.     Palette color spread function was broken in Kickstart 2.0 version of the
  710.       library.  Fixed.  Thanks to Jesper Juul for reporting this bug.
  711.     New danish catalogs and danish install text included (thanks Jesper).
  712.     German catalog for library fixed, some keyboard shortcut keys were used
  713.       twice.
  714.     French catalog for preference editor included (thanks Benoit).
  715.  
  716. *****************************************************************************
  717. RELEASE 2.1d (Library version 38.388 [1.3] - 38.1022 [2.0])
  718.  
  719.     Major new feature: rexx interface to the library.  RexxReqTools is a
  720.       small library that offers lots of rexx commands to use just about all
  721.       ReqTools requesters.  Many thanks to Rafael D'Halleweyn for writing
  722.       this library and giving me permission to include it with ReqTools.
  723.     Finally fixed the refresh bug in the Kickstart 2.0 version of ReqTools.
  724.       Seems it was a bug in the 3.00 ROM.  ReqTools now uses the 'bug-less'
  725.       ScrollWindowRaster() for its window scrolling on 3.0.  Thank you
  726.       Peter Cherna! :-)
  727.     A small bug popped up in the rewriting of the string gadget edit hook
  728.       (Kickstart 2.0 version of ReqTools): keyboard shortcuts were no
  729.       longer possible from integer gadgets.  Fixed.
  730.     Added extra message to install script.  Must still be translated for all
  731.       languages except english and dutch.
  732.     Fixed bug in 'reqtools.i'.  Missing rtfi_IntuiMsgFunc, rtfo_IntuiMsgFunc
  733.       and rtsc_IntuiMsgFunc caused several offsets to be wrong.  Thanks to
  734.       Dirk Vangestel for reporting this.
  735.     Fixed bug in SAS/C and Manx C glue code.  Stubs for rtReqHandler() and
  736.       rtReqHandlerA() didn't save the A6 register.
  737.     Included assembly version of demo source (converted by Dirk Vangestel).
  738.     Most glue code has been archived with LhA (not everyone needs all the
  739.       glue code, just de-archive what you need).
  740.     Fixed enforcer hit in ReqTools preference editor, version 2.1a included.
  741.     Version 1.1b of RTPatch included.
  742.  
  743. *****************************************************************************
  744. RELEASE 2.1e (Library version 38.388 [1.3] - 38.1042 [2.0])
  745.  
  746.     Fixed bug in 'clib/reqtools_protos.h' include file: rtFontRequest() and
  747.       rtScreenModeRequest() had wrong prototypes causing the ReqHandler
  748.       feature to fail to work (without casting).  Thanks to Ebbe Holleris
  749.       Petersen for reporting this problem.
  750.     Fixed small problem in rtEZRequest() requester: if body text was too
  751.       large to fit on the screen and was clipped you could not click on the
  752.       requester's buttons.
  753.     Fixed problem with leading '/' in paths entered in file string gadget.
  754.     Fixed enforcer hits when typing in font requester size gadget.
  755.     Fixed problem with first Shift Down in a file requester with less
  756.       entries than are possibly visible selecting a non-existant entry.
  757.     Fixed problem with typing a single '/' in the path gadget.  This caused
  758.       the file requester to jump to the parent, but the path gadget was
  759.       incorrectly cleared.
  760.     Bug fix: palette requester didn't correctly restore the correct colors
  761.       when it was canceled on an AGA machine with colors from a 24 bit
  762.       palette.  Thanks to Felix Braun for reporting this.  Full AGA support
  763.       will be something for the next release.
  764.     Fixed bug in backfill code.  Didn't always clear window background
  765.       properly on screens with more than 2 bitplanes.  Thanks to David Nouls
  766.       for reporting this.
  767.     Stack checking code in Kickstart 2.0 version of the library completely
  768.       rewritten.  Now uses exec.library StackSwap() to swap the stack.
  769.     Glue code for SAS/C enhanced.  Code hunks are now named 'text' instead
  770.       of 'code', allowing real small code linking.  Glue code now supports
  771.       the autoinitialization and autotermination feature of SAS/C 6.0.  If
  772.       you define ReqToolsBase as external and link with reqtools.lib or
  773.       reqtoolsnb.lib, reqtools.library will be automatically opened.
  774.       Thanks to Brian Ipsen for the suggestion.
  775.     Fixed small bug with rtSetWaitPointer() in HighSpeed Pascal interface.
  776.     Portugese catalogs and install text for library and preference editor
  777.       included.  Translated by Pedro Aguiar.
  778.     Added 'Español' and 'Português' check boxes to languages in install
  779.       script.
  780.     German strings in install script updated by Steffen Salzmann.
  781.     Swedish catalog for library adjusted a bit.
  782.     GCC interface to the library included.  Written by Marc Duponcheel.
  783.     Release 1.2b of RexxReqTools included.
  784.  
  785. *****************************************************************************
  786. RELEASE 2.1f (Library version 38.390 [1.3] - 38.1095 [2.0])
  787.  
  788.     Screenmode requester now knows about EURO72, EURO36, SUPER72, DBLNTSC
  789.       and DBLPAL monitors.
  790.     rtGetVScreenSize() now uses VideoControl() if possible to get the
  791.       visible screen size.
  792.     File requester, font requester and screenmode requester now ignore
  793.       all key presses before the requester is completely set up.  This
  794.       should just about eliminate the problem of a gadget getting pressed
  795.       because the user typed too quickly.
  796.     File requester will use the device name of a volume if it's name is
  797.       not unique (multiple floppies called 'Empty' for example).
  798.     On Kickstart 3.0 or higher the file, font and screenmode requesters will
  799.       use memory pools.
  800.     Palette requester is now fully AGA compatible.  It uses the DisplayInfo
  801.       database to find out the palette range of the screen it is opened on.
  802.       It supports 256 colors out of a pallete of 16,8 million and should
  803.       support even beyond that (not tested since there currently is nothing
  804.       that goes beyond that :-).
  805.     Bug fix: using the close gadget of the palette requester returned 0
  806.       instead of -1 for cancel.
  807.     Bug fix: rtGetLong() requester completely misplaced the min/max display
  808.       when RTGL_TextFmt was used.
  809.     Bug fix: fixed enforcer hits in file requester when FREQF_SELECTDIRS
  810.       was used and a directory was double-clicked.
  811.     Bug fix: font style handling of rtFontRequest() was almost completely
  812.       broken.  Should work ok now.
  813.     Bug fix: min/max display in rtGetLong() requester would become garbled
  814.       during window-refreshing when the RT_ReqHandler feature was used.
  815.     Bug fix: clearing the font name gadget in the rtFontRequest() requester
  816.       and pressing Return caused the requester to return TRUE although
  817.       the 'Cancel' gadget was visibly selected.  The requester now properly
  818.       returns FALSE.
  819.     Fixed some minor errors in include files and autodoc.
  820.     Some updated catalogs included.
  821.     French install text included, translated by Benoit Mortier.
  822.     Release 1.2c of RexxReqTools included.
  823.     Version 1.2 of RTPatch included.
  824.  
  825. *****************************************************************************
  826. RELEASE 2.2 (Library version 38.390 [1.3] - 38.1194 [2.0])
  827.  
  828.     -----------------------------------------------------------------------
  829.     NOTE: All changes listed below are for the Kickstart 2.0 and higher
  830.           version of the library (unless stated otherwise).  Development of
  831.           the 1.3 compatible version of ReqTools has more or less stopped.
  832.     -----------------------------------------------------------------------
  833.     File, font and screenmode are now able to use proportional fonts, making
  834.       them truly font-sensitive.  Palette requester will accept and use a
  835.       proportional font on Kickstart 3.0 or higher only.  Note: this
  836.       required a small catalog change, so be sure to update your catalogs.
  837.     Added cool LED indicator left of the drawer gadget in the file requester.
  838.       People who dislike this can turn this feature off in the ReqTools 2.2
  839.       preference editor.
  840.     File requester will now make sure 'freq->Dir' and 'filename' are
  841.       up-to-date when a callback hook is called (RTFI_FilterFunc and
  842.       RT_IntuiMsgFunc).  If you want to rely on this please check for
  843.       this _exact_ release of ReqTools (or higher of course).
  844.     File requester will show file sizes in localized form now.
  845.     Screenmode requester now handles color depths greater than 8192 colors
  846.       correctly (will use 16K, 32K, 16M,... for high color values).
  847.       Previously the window borders could get overwritten, oops :-)
  848.     Removed hardcoded monitor names from screenmode requester code and made
  849.       screenmode requester construct the name for an unnamed mode from the
  850.       monitor name and dimensions.
  851.     Bug fix: when the SCREQF_GUIMODES flag is used the screenmode requester
  852.       will no longer show modes that haven't got the DIPF_IS_WB flag set.
  853.       This fixes the problem of truecolor Picasso II modes showing up.
  854.     Added a temporary workaround for a SAS/C bug (6.50 and earlier) creating
  855.       incorrect code for taglist switches.  Programs with a missing TAG_END
  856.       in one of their taglists will no longer crash (but are still buggy ;-)
  857.     Changed rtLockWindow() and rtUnlockWindow() nesting code.  Should work
  858.       much better now and allow for infinite nesting.
  859.     Improved calculation of spacing value in rtGetVScreenSize(), will now
  860.       properly return a spacing of 4 for A2024 monitor for example.
  861.     Release 1.2e of RexxReqTools included.
  862.     Version 2.2 of ReqTools preference editor included.
  863.     Version 1.3 of RTPatch included.
  864.  
  865. *****************************************************************************
  866. RELEASE 2.2a (Library version 38.390 [1.3] - 38.1210 [2.0])
  867.  
  868.     Bug fix: on Kickstart 3.0 (V39) the palette requester's slider values
  869.       were sometimes incorrectly displayed (palette requester will now only
  870.       use GTJ_RIGHT on V40 or higher).
  871.     Bug fix: if no locale.library was found (Workbench 2.04) the file and
  872.       font requesters would display a 'D' instead of the file/font size.
  873.     Bug fix: rtSpread() now handles the case where the total size of all
  874.       objects is larger than the total available size correctly (objects will
  875.       overlap in this case of course).
  876.     Quirk fix: file requester will no longer overlap the button gadgets when
  877.       they get too wide for the screen (german locale and lores screen for
  878.       example).  It will scale the buttons in size to make them fit.
  879.     Screenmode requester will no longer fail silently if the current mode
  880.       is invalid.  It now simply picks the first mode id from the current
  881.       list of modes.
  882.     Changed display mode filtering code slightly to fix the problem with
  883.       Picasso II monitor 2.14 (or higher) modes not showing up in the
  884.       screenmode requester.
  885.  
  886. *****************************************************************************
  887. RELEASE 2.2b (Library version 38.390 [1.3] - 38.1248 [2.0])
  888.  
  889.     Bug fix: screenmode requester had some selection problems on certain
  890.       graphic cards (Spectrum, Merlin,...).  Should be fixed now.
  891.     Directory requester will no longer hide the files in directories, but
  892.       will show them ghosted now.  Note that directories will always be
  893.       shown first in the directory requester, regardless of the ReqTools
  894.       prefs setting.
  895.     File requester now has directory completion as well as filename
  896.       completion.  Pressing Alt up/down arrow will select the directory
  897.       that most closely matches the contents of the filename string gadget.
  898.     The file requester now also has volume and assign completion.  Using
  899.       up/down arrow will select the closest matching volume.  Use the Alt
  900.       qualifier to select the closest matching assign.
  901.     The volume list will now first show the volume name, followed by the
  902.       device name.
  903.     New switch in the ReqTools preference editor to force the use of the
  904.       system default font instead of the screen font in the file, volume,
  905.       font, screenmode and palette requesters.
  906.     Fixed enforcer hits in font and screenmode requesters when an intuition
  907.       callback function (RT_IntuiMsgFunc tag) was used.
  908.     Improved method of filtering DOS devices that are shown in the file and
  909.       volume requesters.
  910.     Palette requester: pressing either Alt key with the keyboard shortcut
  911.       for red, green or blue will adjust the color value in steps of 8.
  912.     Fixed SAS/C glue code to be compatible again with the autoinitialization
  913.       and autotermination feature of SAS/C 6.50 and higher.
  914.     Added SAS/C 6.x 'tagcall' pragmas to 'include/pragmas/reqtools.h'.
  915.     Included new glue code for GCC.  Written by Gunther Nikl.
  916.     Version 2.2b of ReqTools preference editor included.
  917.  
  918. *****************************************************************************
  919. RELEASE 2.2c (Library version 38.390 [1.3] - 38.1266 [2.0])
  920.  
  921.     Since using VideoControl() to get the visible display clip only seems
  922.       to work when the screen in question is the frontmost screen the
  923.       rtGetVScreenSize() function now falls back to using QueryOverscan()
  924.       for screens that are in the back (thanks to Dietmar Eilert for
  925.       reporting this).
  926.     Changed method of filtering DOS devices that are shown in the file and
  927.       volume requesters again.
  928.     Window size and gadget layout is now calculated in a sysihack compatible
  929.       way.
  930.     Bug fix: screenmode requester should no longer "lose" characters in the
  931.       color slider values on Kickstarts below V40 (3.1).
  932.     Bug fix: fixed enforcer hits that occured when the screenmode requester
  933.       came up with an empty list (all modes filtered out e.g.).
  934.     Minor bug fix: backfill pattern in EZRequesters now uses BACKGROUNDPEN
  935.       instead of pen 0.
  936.     Polish catalogs for library and preference editor included.  Translated
  937.       by Juan Carlos Marcin Orlowski.
  938.  
  939. *****************************************************************************
  940. RELEASE 2.3 (Library version 38.1292)
  941.  
  942.     -----------------------------------------------------------------------
  943.     NOTE: Update work made by Magnus Holmgren. See start of this file for
  944.           more information.
  945.     -----------------------------------------------------------------------
  946.  
  947.     Release 1.3 of RexxReqTools included.
  948.     Recompiled using DICE 3.01. This was forced by the fact that I don't
  949.       have SAS/C (yet, at lest). As a result, the library now is a couple
  950.       of KBs larger.
  951.     Bug fix: screenmode requester now works better when showing a depth
  952.       gadget for HAM screens. Most notably, the requester will not crash
  953.       under certain circumstances, and will also handle HAM modes with a
  954.       depth of 8 (earlier, only depth 6 was supported). The HAM support was
  955.       a kind of hack, which was incomplete. Its still a hack, but it is
  956.       better now. ;)
  957.     In the file requester, when displaying the volumes list, RMB acts like
  958.       pressing the Get gadget. I.e., you can go back to the original list
  959.       by a simple RMB click. The "Volumes" gadget also acts like Get, if
  960.       pressed while the volume list is displayed.
  961.     The resizable requesters now uses "OS 3 zooming". I.e., the requester
  962.       doesn't move (unless needed) when zoomed.
  963.     Added zoom gadget for the palette requester. When zoomed, the
  964.       requester resizes to "titlebar" size; again, using OS 3 zooming if
  965.       possible.
  966.     Updated the Swedish translation a little.
  967.     In rtEZRequest, function keys can now be used to select the first ten
  968.       gadgets, if enabled in the prefs editor.
  969.     Added the 'Use function keys' option to the prefs program. Currently
  970.       this is the only way to enable this function. In the future there
  971.       will probably be a new tag/flag for this as well.
  972.     Increased the stack some requester functions allocates, if needed.
  973.       Should solve the crashing requesters with some programs when e.g.
  974.       CyberGraphX is installed.
  975.     Added missing tags to ReqTools.h (RTGL_CenterText and RTGS_CenterText).
  976.     Fixed the prefs editor so that all gadgets are updated when new
  977.       settings are loaded.
  978.     Rewrote the DICE-C glue. Now includes autoopen code.
  979.     New distribution layout. There are still two different archives, but
  980.       the contents are different little:
  981.       reqtools<ver>.lha is replaced with reqtools<ver>dev.lha, and contains
  982.       only the developer files (glue, examples, includes and autodocs). The
  983.       user archive (reqtools<ver>usr.lha) haven't changed.
  984.     The filerequester (and the font- and screenmode requester as well) will
  985.       now look better when the screen they open on have "strange" dri-pens.
  986.     Support for OS 1.3 completely dropped. The 1.3 version of
  987.       reqtools.library is no longer included.
  988.     Made a minor change in the ASL patch in RTPatch, so that it returns
  989.       errors more correctly (avoids annoying error requesters after having
  990.       cancelled certain file requesters). I hope the reassemble didn't
  991.       break anything. I haven't tested it much. ;)
  992.  
  993. *****************************************************************************
  994. RELEASE 2.4 (Library version 38.1296)
  995.  
  996.     As you may have noticed, a slightly different version numbering scheme
  997.       have been adopted. I simply removed the letter extensions. ;)
  998.     Fixed a problem in RTPatch, introduced in the re-assembly in 2.3. It
  999.       would (often, but not always) print way too much text.
  1000.     Made some fixes to the installation script. I had forgot to change it.
  1001.       ;)
  1002.     Hopefully fixed the startup crash in the preferences editor.
  1003.     Included glue for Maxon Pascal, written by Falk Zuehlsdorff.
  1004.     rtEZRequestTags() was missing in new DICE glue.
  1005.     Fixed bug in password requester (used by powerpacker.library). DICE bug
  1006.       if you ask me. ;)
  1007.     French, Italian and Polish catalogs updated.
  1008.  
  1009. *****************************************************************************
  1010. RELEASE 2.5 (Library version 38.1387)
  1011.  
  1012.     Now really includes RexxReqTools 1.3. Sorry about that.
  1013.     RTPatch now reports itself as 1.4 (forgot to assemble that minor change
  1014.       ;).
  1015.     Improved pragmas for SAS/C, to make better use of the tagcall. Note
  1016.       that this may cause problems (I got a CXERR in one case). Also
  1017.       changed the name to "reqtools_pragmas.h".
  1018.     Changed the LED rendering a little. It is now done earlier, to work
  1019.       nicer with custom handlers that can be slow in certain operations
  1020.       (like ArcHandler).
  1021.     Recompiled with SAS/C again. ;) I don't think any problem have been
  1022.       introduced due to this.
  1023.     Increased the pattern text buffer in the file requester.
  1024.     The volume list in the file requester should now show all real volumes,
  1025.       including e.g. network volumes. In fact, it should display the same
  1026.       volumes as ASL, since the same algorithm is used. Thanks to Martin
  1027.       Taillefer for showing me how to do it properly.
  1028.     Added a little "hack" to make ReqTools work better with BetterEdit. It
  1029.       was so simple, so why not? ;)
  1030.     Added color wheel to the palette requester! There is a switch in the
  1031.       preferences editor, in case you don't like it. Some notes: You need
  1032.       properly installed colorwheel and gradientslider gadgets (part of OS
  1033.       3.0 or higher) for it to be displayed. The colorwheel will only show
  1034.       up if the screen and window are large enough. The gradient slider
  1035.       doesn't have any fancy background currently, as it requires a rather
  1036.       large number of colors to be displayed nicely, IMHO. And most
  1037.       importantly; the top value of the slider is to the *left* for some
  1038.       reason. Not my fault! ;)
  1039.     Selecting parent in the file requester, when the parent does not exist
  1040.       does now work. Sort of. The drawer gadget is now updated, so that you
  1041.       can "parent back" to a drawer that do exist.
  1042.     In the palette requester, when you are in copy, swap and spread modes,
  1043.       the title of the window will show the current mode.
  1044.     The palette requester should now work better on deep screens (more than
  1045.       8 bits). It will then limit itself to display only 256 colors.
  1046.  
  1047. *****************************************************************************
  1048. RELEASE 2.6 (Library version 38.1413)
  1049.  
  1050.     Forgot to update the proto include file in 2.5.
  1051.     The ReqTools preferences program got wrong (localized) strings
  1052.       sometimes.
  1053.     The file requester still did not show all volumes (but the volume
  1054.       requester sometimes did). I also realized that this change in the
  1055.       volume listing code means that the VREQF_ALLDISKS flags doesn't
  1056.       work. A workaround would be possible (for most disks at least), but
  1057.       is it really worth it?
  1058.     Fixed a bug in the volume listing code, that could cause an incorrect
  1059.       device name to be added to the volume name (if the dol_Task was NULL).
  1060.     E-version of the demo included.
  1061.     The color wheel didn't have its initial color right. Seems like
  1062.       WHEEL_HSB doesn't work on ON_NEW...
  1063.     Added soft link support to the file requester. Note that hooks need to
  1064.       read the link themselves.
  1065.     Russian translation added.
  1066.     Updated Installer script to make use of some new features.
  1067.     The palette requester would try to load the color wheel, and cause
  1068.       Enforcer hits (or worse), when the wheel shouldn't be displayed.
  1069.     The screen depth gadget in the screen mode requester didn't always
  1070.       behave properly. Also added some safety checks.
  1071.     The copy and spread gadgets in the palette requesters didn't work
  1072.       properly. Made a silly mistake when adding the mode indicator in the
  1073.       window title. ;)
  1074.     The color wheel gadget will now always render in monochrome state, to
  1075.       minimize the impact on the screen in question.
  1076.  
  1077. *****************************************************************************
  1078.  
  1079. reqtools.library written by Nico François and Magnus Holmgren
  1080.  
  1081. Thanks to o Kai Bolay for writing the Oberon interface,
  1082.           o Frank Lömker and Michael Griebling for writing the Modula-2
  1083.             interfaces,
  1084.           o Jan van den Baard and Magnus Holmgren for writing the Dice C
  1085.             libraries,
  1086.           o Martin Steppler for writing the Manx C libraries,
  1087.           o Richard Waspe and Gunter Indenhoek for writing the HighSpeed
  1088.             Pascal interfaces,
  1089.           o Chris Pressey for writing the PCQ Pascal interface,
  1090.           o Federico Giannici for the useful suggestions,
  1091.           o Peter Stuer, Gunter Indenhoek, Jorrit Tyberghein, Ives Aerts,
  1092.             Bert Wynants, Mathias Korsbäck, Christoffer Zettermark and
  1093.             Roger Nordin for beta-testing,
  1094.           o Michele Giorato for the Italian catalog translations,
  1095.           o Patrik Nordvall for the Swedish catalog translation,
  1096.           o Per Jacobsen/Jesper Juul for the Danish catalog translations,
  1097.           o Mario Gonzalez for the Norwegian catalog translations,
  1098.           o Juan Carlos Sanchez Garcia for the Spanish translations,
  1099.           o Pedro Aguiar for the Portugese translations,
  1100.           o Benoit Mortier/Georges Goncalves for the French catalog translation,
  1101.           o Dirk Vangestel for the assembly demo source,
  1102.           o Marc Duponcheel and Gunther Nikl for the GCC glue code,
  1103.           o Falk Zuehlsdorff for the Maxon Pascal glue code,
  1104.           o Marcin Orlowski for the Polish translation,
  1105.           o Kertai Gábor for the Hungarian translation,
  1106.           o Dmitry Mikhilov for the Russian translation,
  1107.           o Rafael D'Halleweyn for writing RexxReqTools,
  1108.           o Herman Stevens for being my Fido boss node and having such a
  1109.             great Amiga BBS,
  1110.           o All registered ReqTools users/developers.
  1111.  
  1112.  
  1113. "Cry, if you want to cry
  1114.  If it helps you see
  1115.  If it clears your eyes" - Soundgarden
  1116.  
  1117.  
  1118. (C) 1991-1994 Nico François
  1119.     1995-1996 Magnus Holmgren
  1120.